Remote connections 远程连接
Remote connections 让你从另一台设备控制 Codex:可以用手机查看和推进桌面端任务,也可以让 Codex App 连接 SSH 主机上的项目。
官方内容整理
- 远程连接会复用被连接主机上的项目、线程、文件、凭证、权限、插件、浏览器、Computer Use 和本地工具。
- 你可以远程创建新线程、继续已有线程、发送补充指令、回答问题、审批命令、查看输出、查看 diff、看测试结果和截图。
- 移动端远程控制支持 macOS 和 Windows 上的 Codex App host。设置入口在 Codex App,不在 CLI 或 IDE 扩展。
- 手机端需要安装最新 ChatGPT 移动 App,并登录同一 ChatGPT 账号和工作区。
- 被控电脑需要在线、唤醒、已登录 Codex,并处在可被远程访问的状态。企业工作区可能需要管理员先启用 Remote Control。
- 设置移动端访问时,先在 Codex App 里启动移动端设置流程,再用手机扫描二维码完成绑定。
- 连接后可以在 Settings 的 Connections 中管理设备,配置是否保持唤醒、是否启用 Computer Use、是否安装 Chrome 扩展。
- 可以连接日常使用的笔记本,也可以连接一台常开机器,让 Codex 长时间可达。
- 对已有远程开发环境,可以在 Codex App 中添加 SSH host,让 Codex 在线程中直接读取和修改远程文件系统。
- SSH 方式依赖本机 OpenSSH 配置中的具体 host alias。Codex 会通过 SSH 启动远程 Codex app server。
- 不应把 app-server transport 直接暴露到共享或公网网络。跨网络访问应优先使用 VPN、内网或 mesh 网络。
实践补充
远程连接不是“把 Codex 搬到云上”,而是把控制入口从当前设备扩展到另一台设备。真正执行命令、读取文件、使用登录态的仍然是被连接主机。因此排查问题时要回到 host 看:项目是否存在、依赖是否安装、凭证是否可读、沙盒配置是否允许。
手机远程控制适合审批、查看进度、补充说明和启动已有项目中的轻量任务。需要密集浏览器操作、桌面交互或长时间本地构建时,最好使用常开电脑或远程开发机作为 host。
推荐工作流
- 先选 host:日常电脑、常开桌面机,还是 SSH 开发机。
- 在 host 上完成项目克隆、依赖安装、Codex 登录、插件和 MCP 配置。
- 用本地 Codex 跑一次只读任务,确认环境正常。
- 再启用远程连接或添加 SSH host。
- 远程推进任务时,要求 Codex 输出当前 host、项目路径、权限模式和将要执行的动作。
示例提示词
请帮我设计一套 Codex 远程连接方案。我希望白天在办公室 Mac 上开发,晚上用手机审批和查看任务,另外有一台常开的 Linux 开发机跑长任务。请输出 host 选择、SSH 配置、权限边界和故障排查清单。
我已经把 Codex App 连接到 SSH host。请先只读检查远程项目环境,确认当前路径、Git 状态、依赖管理器、测试命令、Codex 权限模式和可能阻塞自动运行的问题。